home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / libs / 3dlib30a / 3do.doc < prev    next >
Text File  |  1994-03-10  |  6KB  |  131 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                               HyperAct, Inc.                             ║
  5.  ║                               P.O.Box. 5517                              ║
  6.  ║                         Coralville IA 52241 U.S.A                        ║
  7.  ║                          Compuserve - 76350,333                          ║
  8.  ║                        Phone/Fax - (319) 351-8413                        ║
  9.  ║                                                                          ║
  10.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  11.  
  12. *******************************************************************************
  13. *                              3dO Documentation                              *
  14. * Last Update : Feb. 17, 1994.                                                *
  15. *******************************************************************************
  16.  
  17. *******************************************************************************
  18. *                                INTRODUCTION                                 *
  19. *******************************************************************************
  20.  
  21. 3dO is an object compiler that converts text 3d object definitions into 3d 
  22. object files.
  23.  
  24. The objects created with the 3dO object compiler can be used by 3d simple
  25. and complex objects load method.
  26.  
  27. The 3dO program is an alternate way of creating object files, to the method 
  28. that was used up to date, of creating the 3d objects with the 3d program 
  29. (available in another diskette/package).
  30.  
  31. *******************************************************************************
  32. *                                    USAGE                                    *
  33. *******************************************************************************
  34.  
  35. At the command line type :
  36.  
  37.     3DO input[.3dd] [options]
  38.  
  39. where input.3dd is the name of the object definition source.
  40.  
  41. The 3dO program will create a 3d object (.3d2) file for each SIMPLEOBJECT
  42. statement from the original source, and a .3DS file for each COMPLEXOBJECT.
  43.  
  44. C/C++ 3d objects can be created with the /oc+ switch.
  45.  
  46. *******************************************************************************
  47. *                         OBJECT DEFINITION LANGUAGE                          *
  48. *******************************************************************************
  49.  
  50. The 3dO program processes a language that is built out of series of statements.
  51.  
  52. A statement can be specified on multiple lines, if this is the case, a 
  53. continuation mark character MUST be placed at the end of the line. 
  54. The continuation mark line recognized is the '+' (plus) sign.
  55.  
  56. The SIMPLEOBJECT statement syntax is as follows :
  57.  
  58.     SIMPLEOBJECT object-name [NOGEN] +
  59.       POINT point-num x-value y-value z-value +
  60.       POINT ..... +
  61.       LINE from-point to-point +
  62.       LINE ... +
  63.     END-OBJECT
  64.  
  65. Where object-name is the name of the object file, multiple 3d points can be 
  66. specified with the POINT sub-statement, where point-num is a pointer into the 
  67. 3d point array, with x-, y- and z-value the values in the x, y and z dimensions.
  68. Multiple lines are defined using the LINE sub-statement, where from-point and
  69. to-pointsw are pointers into the 3d points array, that describe the edges of 
  70. these lines.
  71. If the optional NOGEN option is specified a stand alone simple object will NOT 
  72. be generated, this is useful if the simple object is used as part of a complex
  73. object.
  74.  
  75. The COMPLEXOBJECT statement syntax is as follows :
  76.  
  77.     COMPLEXOBJECT object-name +
  78.             CHILD child-name [AT x y z] .. +
  79.     END-OBJECT
  80.  
  81. Where object-name is the name of the complex object that will be generated,
  82. child-name is the name of the simple object that will be inserted as a child
  83. to the complex object. 
  84. The optional AT parameter TRANSLATES (moves) the child object to the requested 
  85. position in the 3D space. (for an example of a complex object definition please
  86. refer to the twopyr.3dd sample file provided with this package).
  87.  
  88. Please refer to one of the supplied *.3DD files (e.g. twolayer.3dd) for
  89. an example for the usage of this statement.
  90.  
  91. *******************************************************************************
  92. *                                   General                                   *
  93. *******************************************************************************
  94.  
  95. 3dLIB is distributed by HyperAct, Inc., P.O.Box. 5517 Coralville IA 52241, U.S.A.
  96.  
  97. 3dLIB is (c) copyrighted by Loewy Ron, 1991,93.
  98.  
  99. 3dLIB is a shareware package, please register your copy. To register your copy 
  100. of 3dLIB please refer to the supplied 3DLIB.REG file. 
  101.  
  102. Other programs distributed by HyperAct, Inc. are described in the supplied 
  103. PROGRAMS.TXT file.
  104.  
  105. *******************************************************************************
  106. *                                   Contact                                   *
  107. *******************************************************************************
  108.  
  109. Please contact :
  110.  
  111.         HyperAct, Inc.  
  112.         P.O.Box 5517
  113.         Coralville IA 52241
  114.         U.S.A
  115.  
  116.         E-Mail      : Compuserve - 76350,333
  117.         Phone/Fax   : (319) 351-8413
  118.            
  119. To contact the author directly please write to : 
  120.  
  121.            Loewy Ron
  122.  
  123.         E-Mail      : Compuserve - 100274,162
  124.  
  125. *******************************************************************************
  126. *                                   Credits                                   *
  127. *******************************************************************************
  128.  
  129. 3dLIB and 3dO were written using Turbo Pascal V6.0, Turbo Pascal for Windows 
  130. V1.5 and Borland Pascal with objects V7.0, trademarks of Borland International.
  131.